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5.1  Introduction 

5.1 .1  Description 


This  supplemental  document  contains  the  assembly  language  interface  for  the 
RTEMS  real-time  executive  for  the  Motorola  68020.  For  more  detailed 
information  regarding  exact  operation,  constants,  arguments,  and  data 
structures,  please  refer  to  the  manual  page  for  the  appropriate  directive. 

Each  entry  in  this  document  corresponds  to  a  directive  and  details  which 
registers  are  used  for  input  arguments  and  return  values  in  additioti  to  an 
example  usage.  The  assembly  language  used  in  the  examples  is  standard 
Motoi  ola  68020  assembly. 

S.1 .2  Register  Usage 

RTEMS-68020  uses  the  68020  DO,  Dl,  AO,  and  A1  registers  as  scratch  registers. 
The  contents  of  these  four  registers  will  not  be  preserved  by  RTEMS  directives 
unless  noted  otherwise. 
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S.2  INITIALIZATION  MANAGER 
S.2.1  INIT  EXEC  -  Initialize  RTEMS 


INPUT: 

DO  =  function  code 

4(SP)  =  address  of  configuration  table 

OUTPUT: 

NONE 

EXAMPLE: 


move . 1 

#Conf ig_tbl , - ( SP ) 

*  push 

address  of  config  table 

move . 1 

#INIT_EXEC,DO 

*  DO  = 

function  code 

jar 

rtems 

*  enter  the  executive 

*  does 

not  return 

NOTES: 

This  directive  does  not  return  to  the  caller. 
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S.3  TASK  MANAGER 


S.3.1  T_CREATE  -  Create  a  task 

INPUT: 

DO  =  function  code 

4(SP)  =  user-defined  four  byte  name 

8(SP)  =  priority 

12(SP)  =  stack  size  (in  bytes) 

16(SP)  =  initial  mode 
20(SP)  =  attributes 

24(SP)  =  address  of  task  id  storage  location 
OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 

#TaBk_id,-(SP) 

it 

push 

pointer  to  task  id 

move . 1 

#TASK_ATTRIBUTES , - ( SP ) 

* 

push 

attributes 

move . 1 

#TASK_MODE,-(SP) 

* 

push 

mode 

move . 1 

#STACK_SIZE,-(SP) 

* 

push 

stack  size 

move . 1 

♦priority, -(SP) 

* 

push 

priority 

move . 1 

#TASK_NAME,-(SP) 

♦ 

push 

name 

move . 1 

#T_CREATE,DO 

ft 

DO  = 

function  code 

jsr 

rtems 

ft 

enter  the  executive 

*  should 

check  return  code  here 

S.3.2  T_IDENT  -  Get  ID  of  a  task 


INPUT: 

DO  =  function  code 
4(SP)  =  user-defined  name  to  search  for 

8(SP)  =  node  identifier  (defines  search  space) 

12(SP)  =  address  of  task  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


move.l  #Task_id,-(SP) 
move.i  Inode, -(sp) 

move.l  #TASK_NAME,-(SP) 
move . 1  #T_IDENT , DO 
jsr  rtems 


*  push  pointer  to  task  id 

*  push  node  identifier 

*  push  task  name 

*  DO  =  function  code 

*  enter  the  executive 


*  should  check  return  code  here 
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S.3.3  T  START  -  Start  a  task 


INPUT: 

DO  =  function  code 
4(SP)  =  task  id 

8(SP)  =  entry  point 

12(SP)  =  start  argument 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  iSTART_ARG,-(SP) 
move.l  iUBer_ta3k,-(SP) 
move.l  Taak_id,-(SP) 
move.l  #T_START,D0 
jsr  rtems 

*  should  check  return  code 


*  push  start  argument 

*  push  entry  point 

*  push  task  id 

*  DO  =  function  code 

*  enter  the  executive 

here 


S.3.4  T  RESTART  -  Restart  a  task 


INPUT: 

DO  =  function  code 
4(SP)  =  task  id 

8(SP)  =  restart  argument 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


*  push  restart  argument 

*  push  task  id 

*  DO  =  function  code 

*  enter  the  executive 

*  should  check  return  code  here 


move.l  #RESTART_ARG,-(SP) 
move.l  Task_id, -(SP) 
move . 1  #T_RESTART , DO 

jar  rtems 


S-6 


S.3.5  T_DELETE- Delete  a  task 

INPUT: 

DO  =  function  code 
4(SP)  =  task  id 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move.l  Taak_id,-(SP) 
move.l  #T_DELETE,DO 
jar  rtema 


*  puah  taak  id 

*  DO  =  function  code 

*  enter  the  executive 


*  ahould  check  return  code  here 


S.3.6  T_SUSPEND  -  Suspend  a  task 


INPUT: 

DO  =  function  code 
4(SP)  =  task  id 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 

move.l  Task_id,-(SP) 
move . 1  #T_SUSPEND , DO 
jar  r terns 

*  should  check  return  code  here 


push  task  id 

DO  =  function  code 

enter  the  executive 
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S.3.7  T_RESUME  -  Resume  a  task 

INPUT: 

DO  =  function  code 
4(SP)  =  task  id 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move . 1  Ta8k_id , - ( SP )  ’ 

move . 1  #T_RESUME , DO  ’ 

j  sr  rtems 


push  task  id 

DO  =  function  code 

enter  the  executive 


*  should  check  return  code  here 


S.3.8  T_SETPRI  -  Set  task  priority 


INPUT: 

DO  =  function  code 

4(SP)  =  task  id 

8(SP)  =  new  priority 

1 2(SP)  =  address  of  previous  priority  storage  location 
OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


p?YSrity  ♦**«V-P^'iority,-(SP) 

move.l  #PRIORlTY,-(SP) 
move.l  Ta8k_id,-(SP) 
move.l  #T_SETPR1,D0 
jsr  rtema 

*  should  check  return  code  here 


*  push  pointer  to  previous 

*  push  new  task  priority 

*  push  task  id 

*  DO  =  function  code 

*  enter  the  executive 
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S.3.9  T_MODE  -  Change  current  task’s  mode 

INPUT: 

DO  =  function  code 
4(SP)  =  new  mode 

8(SP)  =  mask 

12(SP)  =  address  of  previous  mode  storage  location 
OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 

#Prev_mode , - ( sp ) 

* 

push  pointer  to  previous  mode 

move . 1 

#MASK,-(SP) 

* 

push  mask 

move . 1 

#MODE,-(SP) 

* 

push  new  mode 

move . 1 

iT_MODE,D0 

* 

DO  =  function  code 

jar 

rtems 

* 

enter  the  executive 

•  should  check  return  code  here 


S.3.1 0  T_GETNOTE  -  Get  task  notepad  entry 


INPUT: 

DO  =  function  code 

4(SP)  =  task  id 

8(SP)  =  notepad  entry  number 

1 2(SP)  =  address  of  note  value  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1  #Note_val , - ( SP ) 

move . 1  iMOTE_NUM, - ( SP ) 

move.l  Ta8k_id,-(SP) 
move .  1  iT__GETNOTE ,  DO 

jsr  rtems 

*  should  check  return  code  here 


*  push  pointer  to  note  value 

*  push  entry  number 

*  push  task  id 

*  DO  =  function  code 

*  enter  the  executive 
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S.3.1 1  T_SETNOTE  -  Set  task  notepad  entry 

INPUT: 

DO  =  function  code 
4(SP)  =  task  id 

8(SP)  =  notepad  entry  number 

12(SP)  =  note  value 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 

iNOTE_VALUE , - ( SP ) 

* 

push 

note  value 

move . 1 

iNOTE_NUM,-(SP) 

* 

push 

entry  number 

move . 1 

Ta8k_id,-(SP) 

* 

push 

task  id 

move.l 

#T_SETNOTE,DO 

* 

DO  * 

function  code 

jar 

rtems 

* 

enter  the  executive 

*  should  check  return  code  here 


S.4  INTERRUPT  MANAGER 
S.4.1  I  ENTER  -  Enter  an  ISR 


INPUT: 

DO  =  function  code 

OUTPUT: 

NONE 

EXAMPLE: 

• 

move.l  d0,-(SP)  *  save  task's  DO 

move.l  #I_ENTER,D0  ♦  DO  =  function  code 

jsr  rtems  *  enter  the  executive 

*  no  need  to  check  the  return  code  here 


NOTES: 

This  directive  uses  the  DO  register  only.  This  register  must  be  saved  by  the 
application  before  invoking  I.ENTER,  The  DO  register  is  restored 
automatically  by  I.RETURN. 
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S.4.2  I  RETURN  -  Return  from  an  ISR 


INPUT: 

DO  =  function  code 

OUTPUT: 

NONE 

EXAMPLE: 


move.l  #I_RETURN,DO  *  DO  =  function  code 

jsr  rtems  *  enter  the  executive 

*  will  never  return 


NOTES: 

This  directive  uses  only  the  DO  register.  It  restores  DO  to  its  contents  prior  to 
I.ENTER. 

This  directive  does  not  retiun  to  the  caller. 
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S.5  TIME  MANAGER 

S.5.1  TM_SET  -  Set  system  date  and  time 


INPUT: 

DO  =  function  code 

4(SP)  =  address  of  timejnfo  data  structure 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move.l  #Tiine_atruct,-(SP)  *  push  pointer  to  time  buffer 

move.l  fTM_SET,D0  *  DO  =  function  code 

jsr  rtema  *  enter  the  executive 

*  should  check  return  code  here 


S-16 


S.5.2  TM_GET  -  Get  system  date  and  time 


INPUT: 

DO  =  function  code 

4(SP)  =  address  of  timejnfo  data  structure 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move.l  #Tiine_8truct,-(SP)  *  push  pointer  to  time  buffer 

move.l  #TM_GET,D0  *  DO  =  function  code 

jsr  rtems  *  enter  the  executive 

*  should  check  return  code  here 
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S.5.3  TM_WKAFTER  -  Wake  up  after  Interval 


INPUT: 

DO  =  function  code 

4(SP)  =  length  of  interval  (in  ticks) 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move.l  # INTERVAL, -(SP) 
move.l  #TM_WKAFTER,DO 
jsr  r terns 

*  should  check  return  code  here 


push  ticks  to  wait 
DO  =  function  code 
enter  the  executive 
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S.5.4  TM_WKWHEN  -  Wake  up  when  specified 


INPUT: 

DO  =  function  code 

4(SP)  =  address  of  timejnfo  data  structure 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move.l  #Time_Btruct,-{SP)  *  push  time  to  wake 

move.l  #TM_WKWHEN,DO  *  DO  =  function  code 

jsr  rtems  *  enter  the  executive 


*  should  check  return  code  here 


S.5.5  TM_EVAFTER  -  Send  event  set  after  interval 

INPUT: 

DO  =  function  code 

4(SP)  =  interval  until  event  (in  ticks) 

8(SP)  =  event  set 

1 2(SP)  =  address  of  timer  id  storage  location 
OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


move.l  #Timer_id,-(SP) 
move.l  #EVENTS,-(SP) 
move . 1  # INTERVAL , - ( SP ) 

move . 1  #TM_EVAFTER , DO 

jsr  rtems 

*  should  check  return  code  here 


*  push  pointer  to  timer  id 

*  push  events  to  send 

*  push  ticks  until  event 

*  DO  =  function  code 

*  enter  the  executive 
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S.5.6  TM_EVWHEN  -  Send  event  set  when  specified 

INPUT: 

DO  =  function  code 

4(SP)  =  address  of  timejnfo  data  structure 

8(SP)  =  event  set 

12(SP)  =  address  of  timer  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 

♦Timer  id,-(SP) 

* 

push 

pointer  to  timer  id 

move . 1 

♦EVENTS, -(SP) 

* 

push 

events  to  send 

move . 1 

♦Time_8truct , - ( SP ) 

* 

push 

time  to  send  events 

move . 1 

♦TM_EVWHEN,DO 

* 

DO  = 

function  code 

jsr 

rtems 

* 

enter  the  executive 

*  should  check  return  code  here 


S.5.7  TM_EVEVERY  -  Send  periodic  event  set 


INPUT: 

DO  =  function  code 

4(SP)  =  interval  between  events  (in  ticks) 

8(SP)  =  event  set 

1 2(SP)  =  address  of  timer  id  storage  location 
OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


move.l  #Tiiner_id,-(SP) 
move.l  #EVENTS,-(SP) 
move . 1  # INTERVAL , - ( SP ) 

move . L  #TMJEVEVERY , DO 

jsr  rtems 

*  should  check  return  code  here 


*  push  pointer  to  timer  id 

*  push  events  to  send 

*  push  time  between  events 
■*  DO  =  function  code 

*  enter  the  executive 


S-22 


S.5.8  TM  CANCEL  -  Cancel  timer  event 


INPUT: 

DO  =  function  code 

4(SP)  =  timer  event  id 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move . 1  Timer_id , - ( SP ) 
move . 1  #TM_CANCEL , DO 
jar  rtems 


*  push  timer  id 

*  DO  =  function  code 

*  enter  the  executive 


*  should  check  return  code  here 


S.5.9  TM  TICK  -  Announce  a  clock  tick 


INPUT: 

DO  =  function  code 

OUTPUT: 

DO  =  SUCCESSFUL 

EXAMPLE: 

move.l  #TM_TICK,D0  *  DO  =  function  code 

jsr  rteme  *  enter  the  executive 

*  no  need  to  check  the  return  code  here 
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S.6  SEMAPHORE  MANAGER 

S.6.1  SM_CREATE  -  Create  a  semaphore 

INPUT: 

DO  =  function  code 

4(SP)  =  user-defined  four  byte  name 

8(SP)  =  initial  count 

12(SP)  -  attributes 

16(SP)  =  address  of  semaphore  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  iSein_id,-(SP)  * 
move.l  #SEM_ArrRIBUTES,-(SP)  * 
move.l  #lNlTIAL_COUNT,-(SP)  * 
move.l  #SEM_HAME,-(SP)  * 
move.l  |SM_CREATE,DO  * 
j  sr  rtems  * 

*  should  check  return  code  here 


push  pointer  to  semaphore  id 
push  attributes 
push  initial  count 
push  name 

DO  K  function  code 
enter  the  executive 
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S.6.2  SM_IDENT  -  Get  ID  of  a  semaphore 


INPUT: 

DO  =  function  code 
4(SP)  =  user-defined  name  to  search  for 

8(SP)  =  node  identifier  (defines  search  space) 

12(SP)  =  address  of  semaphore  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


move.l  #Sein_id,-(SP) 
move , 1  Inode , - ( sp ) 

move.l  #SEM_NAME,-(SP) 
move.l  #SM_1DENT,D0 
jsr  rtems 

*  should  check  return  code  here 


*  push  pointer  to  semaphore  id 

*  push  node  identifier 

*  push  name 

*  DO  =  function  code 

*  enter  the  executive 
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S.6.3  SM^DELETE  -  Delete  a  semaphore 


INPUT: 

DO  =  function  code 

4(SP)  =  semaphore  id 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move . 1  Sem_id, - ( SP ) 

move.l  fSM_DELETE,DO 
j  sr  rtems 


*  push  semaphore  id 

*  DO  »  function  code 

*  enter  the  executive 


*  should  check  return  code  here 


S.6.4  SM_P  -  Acquire  a  semaphore 


INPUT: 

DO  =  function  code 

4(SP)  =  semaphore  id 

8(SP)  =  options 

12(SP)  =  maximum  interval  to  wait  (in  ticks) 
OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1  # INTERVAL , - ( SP ) 

move.l  #OPTZONS,-(SP) 
move.l  sem_id,-(SP) 
ttiove .  1  #SM_P ,  DO 

jsr  rtems 

*  should  check  return  code  here 


*  push  maximum  ticks  to  wait 

*  push  options 

*  push  semaphore  id 

*  DO  «  function  code 

*  enter  the  executive 
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S.6.5  SM_V  -  Release  a  semaphore 

INPUT: 

DO  =  function  code 
4(SP)  =  semaphore  id 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

« 

move.l  seni_id, -(SP)  * 

move.l  #SM_V,D0  * 

j  ar  rtema  * 


push  semaphore  id 
DO  function  code 
enter  the  executive 


*  should  check  return  code  here 


S.7  MESSAGE  MANAGER 
S.7.1  Q_CREATE  -  Create  a  queue 

INPUT: 

DO  =  function  code 
4(SP)  =  user-defined  four  byte  name 

8(SP)  =  maximum  message  count 

12(SP)  =  attributes 

16(SP)  =  address  of  queue  id  storage  location 
OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 

• 

move.l  #Queue__ld,-(SP) 
move.l  #Q_ATTRIB,-(SP) 
move.l  #MSG_BOT_COUNT,-(SP) 
move.l  #QUEtJE_MAME,-(SP) 
move.l  #Q_CREATE,DO 
jsr  rtems 

*  should  check  return  code  here 


*  push  pointer  to  queue  id 

*  push  attributes 

*  push  message  count 

*  push  name 

*  DO  function  code 

*  enter  the  executive 
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S.7.2  QJDENT  -  Get  ID  of  a  queue 


INPUT: 

DO  =  function  code 

4(SP)  =  user-defined  name  to  search  for 

8(SP)  =  node  identifier  (defines  search  space) 

1 2(SP)  =  address  of  queue  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 

iQueue_id,-(SP) 

*  push  pointer  to  queue  id 

move . 1 

Inode, ^(sp) 

*  push  node  identifier 

move . 1 

#QUEUE_NAME , - ( SP ) 

*  push  name 

move . 1 

#Q_1DENT,D0 

*  DO  =  function  code 

jar 

rtems 

•  enter  the  executive 

*  should  check  return  code  here 


S.7.3  Q_DELETE  -  Delete  a  queue 


INPUT: 

DO  =  function  code 
4(SP)  =  queue  id 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 

move . 1  Queue_id , - ( SP ) 

move .  1  #Q_DEr.ETE ,  DO 

jsr  r terns 

*  should  check  return  code  here 


push  queue  id 
DO  =  function  code 
enter  the  executive 
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S.7.4  Q_SEND  -  Put  message  at  rear  of  a  queue 


INPUT: 

DO  =  function  code 

4(SP)  =  queue  id 

8(SP)  =  address  of  message  buffer 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  fMessage  ,-(SP) 
move.l  Queue_ld,>(SP) 
move . 1  #Q_SEND , DO 

j  sr  rtems 


*  push  address  of  message 

*  push  queue  id 

*  DO  =  function  code 

*  enter  the  executive 


*  should  check  return  code  here 


S.7.5  Q_URGENT  -  Put  message  at  front  of  a  queue 

INPUT: 

DO  =  function  code 

4(SP)  =  queue  id 

8(SP)  =  address  of  message  buffer 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


move . 1 

#Message,-(SP) 

*  push  address  of  message 

move . 1 

Queue  id,*'(SP) 

*  push  queue  id 

move . 1 

#Q_^URGENT,DO 

*  DO  =  function  code 

jsr 

rtems 

*  enter  the  executive 

*  should  check  return  code  here 
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S.7.6  Q_BROADCAST  -  Broadcast  N  messages  to  a  queue 


INPUT: 

DO  =  function  code 

4(SP)  =  queue  id 

8(SP)  =  address  of  message  buffer 

1 2(SP)  =  address  of  “number  of  tasks  made  ready"  storage  location 


OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 

move.l  #Num_ta8ks,-(SP) 

move.l  iMes8age,-(SP) 
move.l  Queue_id,-(SP) 
move . 1  #Q_BROADCAST , DO 

jar  rtema 

*  should  check  return  code 


*  push  pointer  to  number 

*  of  tasks  readied 

*  push  address  of  message 
'O  push  queue  id 

*  DO  =  function  code 

*  enter  the  executive 

here 
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S.7.7  Q_RECEIVE  -  Receive  message  from  a  queue 

INPUT: 

DO  =  function  code 

4(SP)  =  queue  id 

8(SP)  =  address  of  message  buffer 

12(SP)  =  options 

1 6(SP)  =  maximum  interval  to  wait  (in  ticks) 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


move.l  #TIMEOUT,-(SP) 
move.l  #OPTIONS,-(SP) 
move.l  |Me88age,-(SP) 
move.l  Queue_id,-(SP) 
move.l  #Q_RECEIVE,DO 
jsr  rteme 

*  should  check  return  code  here 


*  push  maximum  ticks  to  wait 

*  push  receive  options 

*  push  pointer  to  message 

*  push  queue  id 

*  DO  =  function  code 

*  enter  the  executive 
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S.7.8  Q_FLUSH  -  Flush  all  messages  on  a  queue 


INPUT: 

DO  =  function  code 

4(SP)  =  queue  id 

8(SP)  =  address  of  "number  of  messages  flushed"  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 

#Num_£ lushed , - ( SP ) 

* 

push 

pointer  to  number 

* 

of 

messages  flushed 

move . 1 

Queue__id,  -  ( SP ) 

* 

push 

queue  id 

move . 1 

#Q_FLUSH,D0 

* 

DO  « 

function  code 

jsr 

rtems 

* 

enter  the  executive 

*  should  check  return  code  here 


S.8  EVENT  MANAGER 

S.8.1  EV_SEND  -  Send  event  set  to  a  task 

INPUT: 

DO  =  function  code 

4(SP)  =  task  id  to  send  events  to 

8(SP)  =  event  set  to  send 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #EVEMTS,-(SP) 
move.l  Ta8k_id,-(SP) 
move . 1  #EV_SEND , DO 

jsr  rtema 


*  push  events  to  send 

*  push  task  id 

*  DO  =  function  code 

*  enter  the  executive 


*  should  check  return  code  here 
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S.8.2  EV_RECEIVE  -  Receive  event  condition 

INPUT: 

DO  =  function  code 

4(SP)  =  input  event  condition 

8(SP)  =  options 

12(SP)  =  maximum  interval  to  wait  (in  ticks) 

16(SP)  =  address  of  events  received  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move. I  iEvent8_received, 

move.l  #TXCKS,-(SP) 
move . 1  lOPTIOMS , - ( SP ) 

move.l  <BVENTS,-(SP) 
move .  1  #EV__RECEIVE ,  DO 

j  sr  rtema 

*  should  check  return  code  here 


-(SP)  *  push  pointer  to  events  received 

*  push  maximum  ticks  to  wait 

*  push  receive  options 

*  push  event  condition 

*  DO  «  function  code 

*  enter  the  executive 
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S.9  SIGNAL  MANAGER 

S.9.1  AS.CATCH  -  Establish  an  ASR 


INPUT: 

DO  =  function  code 
4(SP)  =  address  of  ASR 

8(SP)  =  mode  of  ASR 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


move . 1 

iASR_MODE,-(SP) 

*  push  ASR  mode 

move . 1 

#A8r_handler , - ( sp ) 

*  push  ASR  address 

move . 1 

#AS_CATCH,DO 

«  t>o  s  function  code 

jar 

rtems 

*  enter  the  executive 

*  should  check  return  code  here 
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S.9.2  AS_SEND  -  Send  signal  set  to  a  task 


INPUT: 

DO  =  function  code 

4(SP)  =  task  id 

8(SP)  =  signal  set 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #S1GNAI.S,-(SP) 
move.l  Ta8k_id,-(SP) 
move . 1  #AS_SEND, DO 
jsr  rtems 


*  push  signals  to  send 

*  push  task  id 

*  DO  >  function  code 

*  enter  the  executive 


*  should  check  return  code  here 


S.9.3  AS  ENTER  -  Enter  an  ASR 


INPUT: 

DO  =  function  code 

OUTPUT: 

NONE 

EXAMPLE: 

move.l  D0,-(SP)  *  save  task  DO 

move.l  #AS_ENTER,d0  *  OO  *  function  code 

jsr  rtems  *  enter  the  executive 

*  no  need  to  check  the  return  code  here 


NOTES: 

This  directive  uses  the  DO  register  only.  This  register  must  be  saved  by  the 
application  before  invoking  AS.ENTER.  The  DO  register  is  restored 
automatically  by  AS.RETURN. 
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S.9.4  AS  RETURN  -  Return  from  an  ASR 


INPUT: 

DO  =  function  code 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move.l  #AS_RETURN,DO  *  DO  =  function  code 

jsr  rtema  *  enter  the  executive 

*  does  not  return  if  SUCCESSFUL 


NOTES: 

This  directive  uses  only  the  DO  register.  It  restores  DO  to  its  contents  prior  to 
AS.ENTER. 

This  directive  does  not  return  to  the  caller. 
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S.10 

PARTITION  MANAGER 

S.10.1 

PT^CREATE  -  Create  a  partition 

INPUT: 

DO 

=  function  code 

4(SP) 

=  user-defined  four  byte  name 

8(SP) 

=  physical  start  address  of  partition 

12(SP) 

=  length  (in  bytes) 

16(SP) 

=  size  of  buffers  (in  bytes) 

20(SP) 

=  attributes 

24(SP) 

=  address  of  partition  id  storage  location 

OUTPUT: 

DO 

=  directive  status  code 

EXAMPLE: 

move.l  #Part_id,-(SP) 
move.l  #PART_ATTRIBUTES,-(SP) 
move . 1  iBUF_SIZE , - ( SP ) 

move.l  #PART_LENGTH,-(SP) 
move . 1  #PART_ADDR, - ( SP ) 

move.l  #PART_NAME,-(SP) 
move . 1  #PT_CREATE , DO 

jar  rtems 

*  should  check  return  code  here 


*  push  pointer  to  partition  id 

*  push  attributes 

*  push  buffer  size 

*  push  length 

*  push  start  address 

*  push  name 

*  DO  =  function  code 

*  enter  the  executive 
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S.1 0.2  PT JDENT  -  Get  ID  of  a  partition 


INPUT: 

DO  =  function  code 
4(SP)  =  user-defined  name  to  search  for 

8(SP)  =  node  identifier  (defines  search  space) 

12(SP)  =  address  of  partition  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #Part_id,-(SP) 
move . 1  Inode , - ( sp ) 

move.l  #PART_NAME,-(SP) 
move.l  #PT_IDENT,DO 
jar  rtems 

*  should  check  return  code  here 


*  push  pointer  to  partition  id 

*  push  node  identifier 

*  push  name 

*  DO  =  function  code 

*  enter  the  executive 
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S.1 0.3  PT_DELETE  -  Delete  a  partition 


INPUT: 

DO  =  function  code 
4(SP)  =  partition  id 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move . 1  Part_id , - ( SP ) 
move .  1  #PT_DEIiETE ,  DO 
jsr  rtems 

*  should  check  return  code  here 
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push  partition  id 
DO  =  function  code 
enter  the  executive 


S.1 0.4  PT^GETBUF  -  Get  buffer  from  a  partition 

INPUT: 

DO  =  function  code 
4(SP)  =  partition  id 

8(SP)  =  address  of  "buffer  address"  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #Buf£_addr,-(SP) 
move.l  Part_id,-(SP) 
move.l  #PT_GETBUF,DO 
jar  rtems 

*  should  check  return  code  here 


*  push  pointer  to  buffer  address 

*  push  partition  id 

*  DO  >  function  code 

*  enter  the  executive 
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S.1 0.5  PT_RETBUF  -  Return  buffer  to  a  partKion 


INPUT: 

DO  =  function  code 
4(SP)  =  partition  id 

8(SP)  =  buffer  address 

OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


*  push  buffer  address 

*  push  partition  id 

*  DO  =  function  code 

*  enter  the  executive 

*  should  check  return  code  here 


move.l  Buff_addr,-(SP) 
move .  1  Par  t__id ,  -  ( SP ) 

move . 1  #PT_RETBUF, DO 

jsr  rtems 
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S.11  REGION  MANAGER 

S.1 1 .1  RN_CREATE  -  Create  a  region 

INPUT: 

DO  =  function  code 
4(SP)  =  user-defined  four  byte  name 

8(SP)  =  physical  start  address  of  region 

12(SP)  =  length  (in  bytes) 

16(SP)  =  page  size  (in  bytes) 

20(SP)  =  attributes 

24(SP)  =  address  of  region  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #Regn^ld,-(SP) 

Biove.l  #REGn3rTTRIB,-<SP) 
move.l  #REGN__PAGE,-(SP) 
move.l  #REGN__LENGTH,-(SP) 
move.l  «REGN_ADDRESS,-'(SP) 
move.l  iREGN__NAME,>(SP) 
move.l  #RN_CRBATE,DO 
j  sr  rtems 

*  should  check  return  code  here 


*  push  pointer  to  region  id 

*  push  attributes 

*  push  page  size 

*  push  length 

*  push  starting  address 

*  push  name 

*  DO  B  function  code 

*  enter  the  executive 


S.1 1 .2  RNJDENT  -  Get  ID  of  a  region 


INPUT: 

DO  =  function  code 

4(SP)  =  user-defined  name  to  search  for 

8(SP)  =  address  of  region  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1  #Regn_id , - ( SP ) 
move.l  #REGN_NAME,-(SP) 
move . X  IRN^IOENT , DO 

jar  rtems 

*  should  check  return  code  here 


*  push  pointer  to  region  id 

*  push  name 

*  DO  =  function  code 

*  enter  the  executive 
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S.11.3  RN  DELETE  -  Delete  a  region 


INPUT: 

DO  =  function  code 
4(SP)  =  region  id 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 

move.l  Regn_id,-(SP) 
move . 1  #RM_DELETE , DO 
jsr  r'teme 

*  should  check  return  code  here 


push  region  id 
DO  >  function  code 
enter  the  executive 


S.1 1 .4  RN_GETSEG  -  Get  segment  from  a  region 


INPUT: 

DO  =  function  code 
4(SP)  =  region  id 

8(SP)  =  segment  size  desired  (in  bytes) 

12(SP)  =  options 

16(SP)  =  maximum  interval  to  wait  (in  ticks) 

20(SP)  =  address  of  "segment  address"  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #seg_addr,-(SP) 
move.l  ♦TIME0UT,-(SP) 
move.l  ioPTIONS,-{SP) 
move.l  fSEG__SIZE,-(SP) 
move . 1  Regn_id , - ( SP ) 

move . 1  f RN_GETSEG , DO 

jar  rtems 

*  should  check  return  code  here 


*  push  pointer  to  segment  address 

*  push  maximum  ticks  to  wait 

*  push  getseg  options 

*  push  desired  segment  size 

*  push  region  id 

*  DO  »  function  code 

*  enter  the  executive 
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S.11.5  RN  RETSEG- Return  segment  to  a  region 


INPUT: 

DO  =  function  code 
4(SP)  =  region  id 

8(SP)  =  segment  address 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  Seg_addr,-(SP) 
move.l  Regn__id,-(SP) 
move . 1  #RN  JRETSEG , DO 

jsr  rtema 


*  push  segment  address 

*  push  region  Id 

*  DO  -  function  code 

*  enter  the  executive 


*  should  check  return  code  here 


S.1 2  DUAL-PORTED  MEMORY  MANAGER 
S.1 2.1  DP_CREATE  -  Create  a  port 

INPUT: 

DO  =  function  code 
4(SP)  =  user-defined  four  byte  name 

8(SP)  =  starting  internal  address 

12(SP)  =  starting  external  address 
16(SP)  =  length  (in  bytes) 

20(SP)  =  address  of  port  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 

#Port_^id,-(SP) 

move . 1 

#PORT_LENGTH , - ( SP ) 

move . 1 

External_addr , - ( SP ) 

move . 1 

lnternal_addr , - ( SP ) 

move . 1 

#PORT_NAME , - { SP ) 

move . 1 

#DP_CREATE,DO 

jar 

rtems 

*  push  pointer  to  port  Id 

*  push  length  of  DPMA 

*  push  external  address 

*  push  Internal  address 

*  push  name 

*  DO  =  function  code 

*  enter  the  executive 


*  should  check  return  code  here 
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S.12.2  DP  JDENT  -  Get  ID  of  a  port 


INPUT: 

DO  =  function  code 

4(SP)  =  user-defined  name  to  search  for 

8(SP)  =  address  of  port  id  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 
move.l 
move.l 
jar 


#Port_id,-(SP) 

push  pointer  to  port  id 

#PORT_HAMB,-(SP) 

* 

push  name 

iDP_^lDEHT,DO 

* 

DO  «  function  code 

rtema 

■* 

enter  the  executive 

*  should  check  return  code  here 


S.1 2.3  DP_DELETE  -  Delete  a  port 


INPUT: 

DO  =  function  code 
4(SP)  =  port  Id 

OUTPUT: 

DO  ==  directive  status  code 
EXAMPLE: 

move.l  Port_id,-(SP) 
move .  1  #DP_DEIiETE  ,  DO 
jsr  rtems 

*  should  check  return  code  here 


push  port  id 

DO  <■  function  code 

enter  the  executive 
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S.1 2.4  DP  2INTERNAL  -  Convert  external  to  internal  address 


INPUT: 

DO  =  function  code 
4(SP)  =  port  id 

8(SP)  =  external  address 

12(SP)  =  address  of  "internal  address"  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


mqve.l  tZnternal  addr,-(SP) 
address  ~ 

move . 1  External_addr , - ( SP ) 

move.l  Port_id,-(SP) 

move .  1  #OP_2  IMTERNAI. ,  DO 

jsr  rtems 

*  should  check  return  code  here 


*  push  pointer  to  internal 

*  push  external  address 

*  push  port  id 

*  DO  B  function  code 

*  enter  the  executive 
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S.1 2.5  DP  2EXTERNAL  -  Convert  Internal  to  external  address 


INPUT: 

DO  =  function  code 
4(SP)  =  port  id 

8(SP)  =  internal  address 

1 2(SP)  =  address  of  "external  address"  storage  location 
OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


mqve.l  iExternal  addr,-(SP) 
address  “ 

move.l  Internal_addr,-(SP) 

move . 1  Port_id , - ( SP ) 

move .  1  #DP_2EXTEBNA1. ,  DO 

jsr  rtems 


*  push  pointer  to  external 

*  push  internal  address 

*  push  port  id 

*  DO  =  function  code 

*  enter  the  executive 


*  should  check  return  code  here 
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S.1 3  INPUT/OUTPUT  MANAGER 
S.1 3.1  DEJNIT  x  Initialize  a  device  driver 

INPUT: 

DO  =  function  code 

4(SP)  =  device  number 

8(SP)  =  address  of  parameter  block 

1 2(SP)  =  address  of  “return  code  from  device  driver"  storage  location 
OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #Drv__rval,-(SP) 

move.l  #Paraun_block,>(SP) 
move.l  #DEV_NUM,-(SP) 
move.l  #OE_INIT,DO 
j  sr  rtems 

*  should  check  directive's  return  code  here 

*  should  check  driver's  return  code  here 


*  push  pointer  to  driver's 

*  return  code 

*  push  pointer  to  parameter  block 

*  push  device  number 

*  DO  =  function  code 

*  enter  the  executive 
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S.1 3.2  DE_OPEN  -  Open  a  device 


INPUT: 

DO  =  function  code 

4(SP)  =  device  number 

8(SP)  =  address  of  parameter  block 

12(SP)  =  address  of  "return  code  from  device  driver"  storage  location 
OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #Drv__rval,-(SP) 

move.l  #Param_block,-(SP) 
move.l  #DEV__NUM,-(SP) 
move  1  #DE_OPEN,D0 
jsr  rtems 


*  push  pointer  to  driver's 

*  return  code 

*  push  pointer  to  parameter  block 

*  push  device  number 

*  DO  =  function  code 

*  enter  the  executive 


*  should  check  directive's  return  code  here 

*  should  check  driver's  return  code  here 
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S.1 3.3  DE_CLOSE  -  Close  a  device 

INPUT: 

DO  =  function  code 

4(SP)  =  device  number 

8(SP)  =  address  of  parameter  biock 

12(SP)  =  address  of  "return  code  from  device  driver"  storage  location 
OUTPUT: 

DO  =  directive  status  code 
EXAMPLE: 


move . 1 

#Drv__rval ,  -  ( SP ) 

*  push  pointer  to  driver's 

*  return  code 

move . 1 

#Param_block , - ( SP ) 

*  push  pointer  to  parameter  block 

move . 1 

#DEV_NUM,-(SP) 

*  push  device  number 

move . 1 

#DE_CLOSE,DO 

*  DO  *  function  code 

jsr 

rtems 

*  enter  the  executive 

*  should  check  directive's  return  code  here 

*  should  check  driver's  return  code  here 


S.13.4  DE  READ  -  Read  from  a  device 


INPUT: 

DO  =  function  code 

4(SP)  =  device  number 

8(SP)  =  address  of  parameter  block 

1 2(SP)  =  address  of  "return  code  from  device  driver"  storage  location 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.l  #Dirv_rval,-(SP) 

move.l  #parain_block,-(SP) 
move . 1  #DEV_NUM, - ( SP ) 

move.l  #DE_READ,D0 
jsr  rtems 

*  should  check  directive's  return  code  here 

*  should  check  driver's  return  code  here 


*  push  pointer  to  driver's 

*  return  code 

*  push  pointer  to  parameter  block 

*  push  device  number 

*  DO  =  function  code 

*  enter  the  executive 
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S.1 3.5  DE  WRITE  -  Write  to  a  device 


INPUT: 

DO  =  function  code 

4(SP)  =  device  number 

8(SP)  =  address  of  parameter  block 

12(SP)  =  address  of  “return  code  from  device  driver"  storage  location 
OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move.  I  #Drv__i:val,-(SP) 

move.l  iParam_block,-(SP) 
move.l  #DEV_NUM,-(SP) 
move . 1  #DE_WRITE , DO 
jsr  rtems 

*  should  check  directive's  return  code  here 

*  should  check  driver's  return  code  here 


*  push  pointer  to  driver's 

*  return  code 

*  push  pointer  to  parameter  block 

*  push  device  number 

*  DO  »  function  code 

*  enter  the  executive 
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S.1 3.6  DE_CNTRL  -  Special  device  services 


INPUT: 

DO  =  function  code 

4(SP)  =  device  number 

8(SP)  =  address  of  parameter  block 

12(SP)  =  address  of  "return  code  from  device  driver"  storage  location 
OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


move . 1 

#Drv_rval , - ( SP ) 

* 

push  pointer  to  driver's 

* 

return  code 

move . 1 

#Param_block , - ( SP ) 

♦ 

push  pointer  to  pareuneter  block 

move . 1 

#DEV_NUM,-<SP) 

push  device  number 

move . 1 

#DE_CNTRL,DO 

* 

DO  =  function  code 

jsr 

rtems 

enter  the  executive 

*  should 

check  directive's 

return 

code  here 

*  should  check  driver's  return  code  here 
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S.1 4  FATAL  ERROR  MANAGER 

S.1 4.1  K  FATAL  -  Invoke  the  fatal  error  handler 


INPUT: 

DO  =  function  code 
4(SP)  =  error  code 

OUTPUT: 

NONE 

EXAMPLE: 


move . 1 

Fataljerror , - ( SP ) 

*  push  error  code 

move . 1 

#K_FATAL,D0 

*  DO  =  function  code 

jar 

rtems 

*  enter  the  executive 

*  will 

never  return 

NOTES: 

This  directive  does  not  return  to  the  caller. 


S.1 5  MULTIPROCESSING 

S.1 5.1  MP_ANNOUNCE  -  Announce  the  arrival  of  a  packet 


INPUT: 

DO  =  function  code 

OUTPUT: 

NONE 

EXAMPLE: 


move.l  #MP_ANNOUNCK,DO  *  DO  *  function  code 

3®^  rtema  *  enter  the  executive 

*  no  need  to  check  the  return  code  here 
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S.16  dfrectives.eq 


********************************************************** 

* 

*  directives • eq 

* 

*  The  following  definitions  are  the  directive  numbers 

*  used  in  the  assembly  interface. 

* 

*  NOTE:  For  standard  Motorola  MC680x0  series  assemblers. 

* 


INIT_EXEC 

EQU 

0 

I_ENTER 

EQU 

1 

I_RETURN 

EQU 

2 

K_FATAL 

EQU 

3 

TM_SET 

EQU 

4 

TMjGET 

EQU 

5 

TM_WKAFTER 

EQU 

£ 

TMJWKWHEN 

EQU 

7 

TM_EVAFTER 

EQU 

8 

TM_EVWHEN 

EQU 

9 

TM_EVEVERY 

EQU 

10 

TM_CANCBL 

EQU 

11 

TM_T1CK 

EQU 

12 

T^CREATE 

EQU 

13 

TRIDENT 

EQU 

14 

T_START 

EQU 

15 

T_RESTART 

EQU 

16 

T_DEIiETE 

EQU 

17 

T_SUSPEND 

EQU 

18 

T_RESUME 

EQU 

19 

T_SETPRI 

EQU 

20 

T_MODE 

EQU 

21 

T  GETNOTE 

EQU 

22 

T_SETNOTE 

EQU 

23 

EV_SEND 

EQU 

24 

EV_RECEIVE 

EQU 

25 

AS_CATCH 

EQU 

26 

AS_SEND 

EQU 

27 

AS_ENTER 

EQU 

28 

AS_RETURN 

EQU 

29 

Q_CREATE 

EQU 

30 

Q_IDENT 

EQU 

31 

Q_DELETE 

EQU 

32 

0_SEND 

EQU 

33 

Q  URGENT 

EQU 

34 
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Q_BROADCAST 

EQU 

35 

Q_RECEIVE 

EQU 

36 

Q_FLUSH 

EQU 

37 

SM_CREATE 

EQU 

38 

SM_IDEIIT 

EQU 

39 

SM_DEI.ETE 

EQU 

40 

SM_P 

EQU 

41 

SM_V 

EQU 

42 

RN_CREATE 

EQU 

43 

RN_IDENT 

EQU 

44 

RN_DELETE 

EQU 

45 

RN_GETSEG 

EQU 

46 

RN_RETSEG 

EQU 

47 

PT_CREATE 

EQU 

48 

PT_IDENT 

EQU 

49 

PT_DELETE 

EQU 

50 

PT_GETBUP 

EQU 

51 

PT_RETBUF 

EQU 

52 

DP_CREATE 

EQU 

53 

DP_IDENT 

EQU 

54 

DP__DELETE 

EQU 

55 

DP_2 INTERNAL 

EQU 

56 

DP__2EXTERNAL 

EQU 

57 

MP__ANNOUNCE 

EQU 

58 

DE__INIT 

EQU 

59 

DE_OPEN 

EQU 

60 

DE_CLOSE 

EQU 

61 

DE^READ 

EQU 

62 

DE_WRITE 

EQU 

63 

DE_CNTRL 

EQU 

64 

BEGIN_CODE_DCL 

global  rtems  *  single  RTENS  entry  point 

END_CODE_DCL 

*  end  of  directives. eg 

* 

************1r********tflt*lHti,it*i,i,i,i,i,iHHH,ii1,'^.i,t1i***t'k*ititit***lili 
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S.17  dirstatus.eq 


* 

*  dirstatus.eq 

* 

*  This  include  file  contains  the  status  codes  returned 

*  from  the  executive's  directives. 

* 

*  NOTEx  For  standard  Motorola  mc680x0  series  assemblers. 

* 


SUCCESSFUL 

EQU 

0 

* 

successful  completion 

E_EXITTED 

EQU 

1 

* 

returned  from  a  task 

E__NOMP 

EQU 

2 

* 

multiprocessing  not  configured 

E  NAME 

EQU 

3 

* 

invalid  object  neune 

o 

H 

«' 

EQU 

4 

* 

invalid  object  id 

E_TOOMANY 

EQU 

5 

* 

too  many 

E_TIMEOUT 

EQU 

6 

* 

timed  out  waiting 

E_DELETE 

EQU 

7 

* 

object  was  deleted  while  waiting 

E_SIZE 

EQU 

8 

* 

specified  size  was  invalid 

E_ADDRESS 

EQU 

9 

* 

address  specified  is  invalid 

E_NUMBER 

EQU 

10 

* 

number  was  invalid 

E_NOTDEFINEO 

EQU 

11 

* 

item  has  been  initialized 

E_INUSE 

EQU 

12 

* 

resources  still  outstanding 

B_UNSATISF1ED 

EQU 

13 

♦ 

request  not  satisfied 

E_STATE 

EQU 

14 

* 

task  is  in  wrong  state 

E_ALR£ADY 

EQU 

15 

* 

task  already  in  state 

E_SELP 

EQU 

16 

* 

illegal  on  calling  task 

E_REMOTE 

EQU 

17 

* 

illegal  on  remote  object 

E_CALLED 

EQU 

18 

* 

called  from  wrong  environment 

E_PRIORITY 

EQU 

19 

* 

invalid  task  priority 

E_CLOCK 

EQU 

20 

* 

invalid  date/time 

E_NODE 

EQU 

21 

* 

invalid  node  id 

E_NOTCOHFIGURED 

EQU 

22 

* 

directive  not  configured 

E_NOTIMPLEMENTED 

EQU 

23 

* 

directive  not  implemented 

*  end  of  dirstatus.eq 

it 

********************************************************** 
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